Download Installer

Route

/v2/installer/{platform}/{version}

Description

Download Cyberhaven sensor installers for Windows, macOS, and Linux platforms. Use this endpoint to programmatically retrieve installer packages for automated deployment.

Method

GET

Inputs

Parameter	Type	Required	Description
platform	string	Yes	Target platform (windows, macos, linux)
version	string	Yes	Version to download (latest, previous, or specific version)
format	string	No	Package format for Linux (deb, rpm) - defaults to deb

Path Parameters

• platform: Must be one of windows, macos, or linux
• version: Can be latest, previous, or specific version number (e.g., 24.03.90.366)

Query Parameters

• format: Only applicable for Linux platform
  • deb: Debian package format (default)
  • rpm: Red Hat package format

Request Examples

# Download latest Windows installer
GET /v2/installer/windows/latest

# Download previous macOS installer
GET /v2/installer/macos/previous

# Download specific Linux version as DEB
GET /v2/installer/linux/24.03.90.366?format=deb

# Download latest Linux installer as RPM
GET /v2/installer/linux/latest?format=rpm

Output

Field	Type	Description
Response Body	binary	Installer package file
Content-Type	string	application/octet-stream
Content-Disposition	string	attachment; filename="installer-name"
X-Installer-Version	string	Version of the downloaded installer

Platform-Specific Outputs

Platform	File Extension	Description
Windows	.msi	Microsoft Installer package
macOS	.pkg	Apple Installer package
Linux (DEB)	.deb	Debian package
Linux (RPM)	.rpm	Red Hat package

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response Headers

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="cyberhaven-sensor-windows-24.03.90.366.msi"
X-Installer-Version: 24.03.90.366
Content-Length: 52428800